home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 44 / Amiga Format CD44 (1999-08-26)(Future Publishing)(GB)(Track 1 of 3)[!][issue 1999-10].iso / -in_the_mag- / basics / amos / easylife110_p1.lha / Include / MUI-Hook-Functions.i < prev    next >
Text File  |  1992-02-26  |  2KB  |  56 lines
  1. *****************************************************************************
  2. * Easylife MUI Assembler Hook Funcion Include File. V1.07
  3. * =======================================================
  4. *
  5. *
  6. * When your hook function is called the following variables may be accessed
  7. * as offsets from address register A3.
  8. *
  9. * E.g. The address of the application object can be found with:
  10. *      Move.l AppObj(a3),a0
  11. *
  12. * Also, when your hook is called:
  13. *
  14. * A0 = Address of the start of your hook code that is executing
  15. *
  16. * A1 = As defined by the MUI Function calling your hook. Usually a string,
  17. *      structure, or taglist specifying arguments.
  18. *
  19. * A2 = As defined by the MUI Function calling your hook. Usually a pointer
  20. *      to a relevant object. 
  21. *
  22. * A3 = Base for variables defined below
  23. *
  24. *
  25. * A4 = Address of data area you passed to the Elmui Hook function when
  26. *      creating the hook.
  27. *
  28. * A5 = Normal AMOS Value of A5 when programing extensions. It is a pointer
  29. *      to the main AMOS data zone, defined in the file  "|equ.s" which
  30. *      is in the extensions drawer of AMOS's Extras: or AMOSPro_Tutorial:
  31. *
  32. * A6 = Intuition Base
  33. *
  34. * A7 = The Stack Pointer
  35. *
  36. *
  37. * Easylife will store the neccessary registers before your hook is called,
  38. * and restore them on exit - you may trash any register you want (Except
  39. * A7 of course). If you need to return a value to MUI, put it in D0.
  40. *
  41. *
  42. *
  43. * Offsets from A3:
  44.  
  45. ElMUI_AMOS_A5    equ    -8    ;Also in a5
  46. ElMUI_IntBase    equ    -4    ;Also in a6
  47. ELMUI_MUIBase    equ    0    ;Base of muimaster.library
  48.                 ;Do not close it!
  49. ELMUI_Tags    equ    4    ;Bank number of current tagbank
  50. ELMUI_TagLists    equ    8    ;Bank number of current taglist bank
  51. ELMUI_AppObj    equ    12    ;Address of the application object
  52.                 ;(Or 0 if none exists)
  53.  
  54. * Do not use values outside this range - Other easylife extension data
  55. * is stored there, and its use may change in the future.        
  56.